Get Virtual Machine Title 

Copies the virtual machine title to the specified buffer.

mov  ah, 16h           ; Windows multiplex function

mov  al, 8Eh           ; VM Title

mov  di, seg VMTitle   ; see below

mov  es, di

mov  di, offset VMTitle

mov  cx, Size          ; see below

mov  dx, 3             ; Get Virtual Machine Title

int  2Fh

cmp  ax, 1

je   success

 

Parameters

VMTitle

Address of a buffer that receives the virtual machine title. This parameter must not be zero.

Size

Size, in bytes, of the buffer pointed to by VMTitle.

 

Return Value

Returns 1 in the AX register if successful or zero otherwise.

Remarks

Get Virtual Machine Title copies as much of the title as possible, but never more than the specified number of bytes. The function always appends a terminating null character to the title in the buffer.